package com.miniapp.service;

import cn.hutool.db.PageResult;
import com.miniapp.domain.dto.ApiAccessLogCreateReqDTO;
import com.miniapp.entity.ApiAccessLog;
import com.miniapp.domain.vo.ApiAccessLogPageReqVO;

/**
 * @author author
 * @date 2025-09-18 15:30
 */
public interface ApiAccessLogService {

    /**
     * 创建 API 访问日志
     *
     * @param createReqDTO API 访问日志
     */
    void createApiAccessLog(ApiAccessLogCreateReqDTO createReqDTO);

    /**
     * 获得 API 访问日志分页
     *
     * @param pageReqVO 分页查询
     * @return API 访问日志分页
     */
    PageResult<ApiAccessLog> getApiAccessLogPage(ApiAccessLogPageReqVO pageReqVO);

    /**
     * 清理 exceedDay 天前的访问日志
     *
     * @param exceedDay   超过多少天就进行清理
     * @param deleteLimit 清理的间隔条数
     */
    Integer cleanAccessLog(Integer exceedDay, Integer deleteLimit);

}
